GET Hero Statistics
/openmlbb/academy/heroes/{hero_identifier}/stats
API Path: /api/academy/heroes/{hero_identifier}/stats
Retrieve performance statistics for a specific hero by rank. Supports query parameters for rank, pagination, and localization.
Path parameters:
- hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like
30,Yi Sun-shin, oryisunshin.
Query parameters:
- rank: Rank filter. Allowed values:
all,epic,legend,mythic,honor,glory. - size: Number of items per page (minimum: 1).
- index: Page index (starting from 1).
- lang: Language code for localized content (default:
en).
The response includes hero statistics data:
- records: Array of hero entries, each containing:
- _id: Unique record identifier.
- _createdAt: Creation timestamp.
- _updatedAt: Last update timestamp.
- data:
- main_hero:
- data:
- hero:
- data:
- head: Main hero portrait image URL.
- name: Main hero name.
- data:
- hero:
- data:
- main_heroid: Main hero ID.
- main_hero_appearance_rate: Pick rate of the main hero.
- main_hero_ban_rate: Ban rate of the main hero.
- main_hero_win_rate: Win rate of the main hero.
- sub_hero: Array of synergy heroes, each containing:
- heroid: Hero ID.
- hero_win_rate: Win rate of the synergy hero.
- hero_appearance_rate: Pick rate of the synergy hero.
- increase_win_rate: Positive synergy impact on win rate.
- min_win_rate6-20: Win rate breakdown across match durations.
- hero:
- data:
- hero:
- data:
- head: Synergy hero portrait image URL.
- data:
- hero:
- data:
- sub_hero_last: Array of negative synergy heroes, each containing:
- heroid: Hero ID.
- hero_win_rate: Win rate of the sub-hero.
- hero_appearance_rate: Pick rate of the sub-hero.
- increase_win_rate: Negative impact on win rate.
- min_win_rate6-20: Win rate breakdown across match durations.
- main_hero:
This endpoint is useful for:
- Analyzing hero performance across different ranks.
- Understanding meta trends.
- Guiding players in hero selection and strategy.
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.academy.hero_stats("miya", rank="all", size=20, index=1, lang="en")
print(response)Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| hero_identifier | path | string | yes | - |
| rank | query | string | no | all |
| size | query | integer | no | 20 |
| index | query | integer | no | 1 |
| lang | query | string | no | en |